using System.Collections.Generic;
using System.Threading.Tasks;
using JGSY.CMS.LowCode.Platform.Domain.Entities;

namespace JGSY.CMS.LowCode.Platform.Domain.Interfaces
{
    /// <summary>
    /// 用户角色仓储接口
    /// 提供用户角色关联关系的数据访问操作，包括角色分配、移除和查询等功能
    /// </summary>
    public interface IUserRoleRepository
    {
        /// <summary>
        /// 获取所有用户角色关联关系
        /// </summary>
        /// <returns>用户角色关联关系列表</returns>
        Task<IEnumerable<UserRole>> GetAllAsync();
        
        /// <summary>
        /// 添加用户角色关联关系
        /// </summary>
        /// <param name="entity">用户角色关联实体</param>
        /// <returns>添加操作的异步任务</returns>
        Task AddAsync(UserRole entity);
        
        /// <summary>
        /// 移除用户角色关联关系
        /// </summary>
        /// <param name="userId">用户标识符</param>
        /// <param name="roleId">角色标识符</param>
        /// <returns>移除操作的异步任务</returns>
        Task RemoveAsync(long userId, long roleId);
        
        /// <summary>
        /// 获取用户的所有角色
        /// </summary>
        /// <param name="userId">用户标识符</param>
        /// <returns>用户拥有的角色列表</returns>
        Task<IEnumerable<Role>> GetRolesByUserAsync(long userId);

        /// <summary>
        /// 获取指定角色的所有用户
        /// </summary>
        /// <param name="roleId">角色标识符</param>
        /// <returns>拥有该角色的用户列表</returns>
        Task<IEnumerable<User>> GetUsersByRoleAsync(long roleId);

        /// <summary>
        /// 检查用户是否拥有指定角色
        /// </summary>
        /// <param name="userId">用户标识符</param>
        /// <param name="roleId">角色标识符</param>
        /// <returns>如果用户拥有该角色返回true，否则返回false</returns>
        Task<bool> UserHasRoleAsync(long userId, long roleId);

        /// <summary>
        /// 检查用户是否拥有指定角色名称的角色
        /// </summary>
        /// <param name="userId">用户标识符</param>
        /// <param name="roleName">角色名称</param>
        /// <returns>如果用户拥有该角色返回true，否则返回false</returns>
        Task<bool> UserHasRoleAsync(long userId, string roleName);

        /// <summary>
        /// 批量为用户分配角色
        /// </summary>
        /// <param name="userId">用户标识符</param>
        /// <param name="roleIds">角色标识符集合</param>
        /// <returns>批量分配操作的异步任务</returns>
        Task AssignRolesToUserAsync(long userId, IEnumerable<long> roleIds);

        /// <summary>
        /// 移除用户的所有角色
        /// </summary>
        /// <param name="userId">用户标识符</param>
        /// <returns>移除操作的异步任务</returns>
        Task RemoveAllRolesFromUserAsync(long userId);

        /// <summary>
        /// 更新用户的角色分配
        /// 先移除所有现有角色，然后分配新角色
        /// </summary>
        /// <param name="userId">用户标识符</param>
        /// <param name="roleIds">新的角色标识符集合</param>
        /// <returns>更新操作的异步任务</returns>
        Task UpdateUserRolesAsync(long userId, IEnumerable<long> roleIds);
    }
}
